home *** CD-ROM | disk | FTP | other *** search
/ IRIX Base Documentation 2001 May / SGI IRIX Base Documentation 2001 May.iso / usr / share / catman / a_man / cat1 / lboot.z / lboot
Encoding:
Text File  |  2001-04-17  |  9.7 KB  |  199 lines
  1.  
  2.  
  3.  
  4. llllbbbbooooooootttt((((1111MMMM))))                                                            llllbbbbooooooootttt((((1111MMMM))))
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      lboot - configure bootable kernel
  10.  
  11. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  12.      llllbbbbooooooootttt _o_p_t_i_o_n_s
  13.  
  14. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  15.      The _l_b_o_o_t command is used to configure a bootable UNIX kernel.  Master
  16.      files in the directory _m_a_s_t_e_r contain configuration information used by
  17.      _l_b_o_o_t when creating a kernel.  System files in the directory _s_y_s_t_e_m are
  18.      used by _l_b_o_o_t to determine which modules are to be configured into the
  19.      kernel.
  20.  
  21.      If a module in _m_a_s_t_e_r is specified in the _s_y_s_t_e_m file via "INCLUDE:",
  22.      that module is included in the bootable kernel.  For all included
  23.      modules, _l_b_o_o_t searches the _b_o_o_t directory for an object file with the
  24.      same name as the file in _m_a_s_t_e_r, but with a ....oooo or ....aaaa appended.  If found,
  25.      this object is included when building the bootable kernel.
  26.  
  27.      For every module in the _s_y_s_t_e_m file specified via "VECTOR:", _l_b_o_o_t takes
  28.      actions to determine if a hardware device corresponding to the specified
  29.      module exists.  Generally, the action is a memory read at a specified
  30.      base, of the specified size.  If the read succeeds, the device is assumed
  31.      to exist, and its module is also included in the bootable kernel.
  32.  
  33.      Master files that are specified in the _s_y_s_t_e_m file via "EXCLUDE:" are
  34.      also examined; stubs are created for routines specified in the excluded
  35.      master files that are not found in the included objects.
  36.  
  37.      Master files that are specified in the _s_y_s_t_e_m file via "USE:" are treated
  38.      as though the file were specified via the "INCLUDE:" directive, if an
  39.      object file corresponding to the master file is found in the _b_o_o_t
  40.      directory.  If no such object file is found, "USE:" is treated as
  41.      "EXCLUDE:".
  42.  
  43.      To create the new bootable object file, the applicable master files are
  44.      read and the configuration information is extracted and compiled.  The
  45.      output of this compilation is then linked with all included object files.
  46.      Unless directed otherwise in the _s_y_s_t_e_m file, the information is compiled
  47.      with $$$$TTTTOOOOOOOOLLLLRRRROOOOOOOOTTTT////uuuussssrrrr////bbbbiiiinnnn////cccccccc and combined with the modules in the _b_o_o_t
  48.      directory using $$$$TTTTOOOOOOOOLLLLRRRROOOOOOOOTTTT////uuuussssrrrr////bbbbiiiinnnn////lllldddd.
  49.  
  50.      The options are:
  51.  
  52.      ----mmmm _m_a_s_t_e_r   Specifies the directory containing the master files to be
  53.                  used for the bootable kernel.  The default _m_a_s_t_e_r directory
  54.                  is $_R_O_O_T/_v_a_r/_s_y_s_g_e_n/_m_a_s_t_e_r._d.
  55.  
  56.      ----ssss _s_y_s_t_e_m   Specifies the directory containing the system files.  The
  57.                  default _s_y_s_t_e_m directory is $_R_O_O_T/_v_a_r/_s_y_s_g_e_n/_s_y_s_t_e_m.
  58.  
  59.  
  60.  
  61.  
  62.  
  63.                                                                         PPPPaaaaggggeeee 1111
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. llllbbbbooooooootttt((((1111MMMM))))                                                            llllbbbbooooooootttt((((1111MMMM))))
  71.  
  72.  
  73.  
  74.      ----bbbb _b_o_o_t     Specifies the directory where object files are to be found.
  75.                  The default _b_o_o_t directory is $_R_O_O_T/_v_a_r/_s_y_s_g_e_n/_b_o_o_t.
  76.  
  77.      ----nnnn _m_t_u_n_e    Specifies the directory where tunable parameters are to be
  78.                  found.  The default _m_t_u_n_e directory is
  79.                  $_R_O_O_T/_v_a_r/_s_y_s_g_e_n/_m_t_u_n_e.
  80.  
  81.      ----cccc _s_t_u_n_e    Specifies the name of the file defining customized tunable
  82.                  parameter values.  The default _s_t_u_n_e file is
  83.                  $_R_O_O_T/_v_a_r/_s_y_s_g_e_n/_s_t_u_n_e.
  84.  
  85.      ----rrrr _R_O_O_T     RRRROOOOOOOOTTTT becomes the starting pathname when finding files of
  86.                  interest to _l_b_o_o_t.  Note that this option sets RRRROOOOOOOOTTTT as the
  87.                  search path for include files used to generate the target
  88.                  kernel.  If this option is not specified, the RRRROOOOOOOOTTTT
  89.                  environment variable (if any) is used instead.
  90.  
  91.      ----vvvv          Makes _l_b_o_o_t slightly more verbose.
  92.  
  93.      ----uuuu _u_n_i_x     Specifies the name of the target kernel.  By default, it is
  94.                  uuuunnnniiiixxxx....nnnneeeewwww, unless the ----tttt option is used, in which case the
  95.                  default is uuuunnnniiiixxxx....iiiinnnnssssttttaaaallllllll.
  96.  
  97.      ----dddd          Displays debugging information about the devices and modules
  98.                  put in the kernel.
  99.  
  100.      ----aaaa          Used to auto-register all dynamically loadable kernel modules
  101.                  that contain a dddd and an RRRR in their master files.  Only the
  102.                  auto-register is performed, a kernel is not configured.
  103.  
  104.      ----NNNN          Disables auto-registering of all dynamically loadable
  105.                  modules.  A kernel is produced, but no auto-registration is
  106.                  performed.
  107.  
  108.      ----llll          Used to ignore the dddd in all master files and link all
  109.                  necessary modules into the kernel.
  110.  
  111.      ----eeee          Causes the result of whether an auto-config would have been
  112.                  performed to be printed, but no actual configuration is
  113.                  built.
  114.  
  115.      ----wwww          Used to specify a work directory into which the _m_a_s_t_e_r._c and
  116.                  _e_d_t._l_i_s_t files are written.  By default these files are
  117.                  written into the _b_o_o_t directory.
  118.  
  119.      ----tttt          Tests if the existing kernel is up-to-date.  If the kernel is
  120.                  not up-to-date, it prompts you to proceed.  It compares the
  121.                  modification dates of the _s_y_s_t_e_m files, the object files in
  122.                  the _b_o_o_t directory, the modification time of the boot
  123.                  directory, the configuration files in the _m_a_s_t_e_r._d directory
  124.                  and the modification time of the _s_t_u_n_e file with that of the
  125.                  existing kernel.  It also probes for the devices specified
  126.  
  127.  
  128.  
  129.                                                                         PPPPaaaaggggeeee 2222
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. llllbbbbooooooootttt((((1111MMMM))))                                                            llllbbbbooooooootttt((((1111MMMM))))
  137.  
  138.  
  139.  
  140.                  with "VECTOR:" lines in the _s_y_s_t_e_m file.  If the devices have
  141.                  been added or removed, or if the kernel is out-of-date, it
  142.                  builds a new kernel, adding ....iiiinnnnssssttttaaaallllllll to the target name.
  143.  
  144.      ----TTTT          Performs the same function as the ----tttt option, but does not
  145.                  prompt you to proceed.
  146.  
  147.      ----OOOO _t_a_g_s     Specifies tags to be used to select which tunable parameters
  148.                  to use as part of the the kernel build.  Multiple ----OOOO options
  149.                  may be given.
  150.  
  151.      ----LLLL _m_a_s_t_e_r   Specifies the name of the dynamically loadable kernel module
  152.                  to load into the running kernel.  _m_a_s_t_e_r is the name of a
  153.                  master file in the $_R_O_O_T/_v_a_r/_s_y_s_g_e_n/_m_a_s_t_e_r._d directory.
  154.  
  155.      ----RRRR _m_a_s_t_e_r   Specifies the name of the dynamically loadable kernel module
  156.                  to register.  _m_a_s_t_e_r is the name of a master file in the
  157.                  $_R_O_O_T/_v_a_r/_s_y_s_g_e_n/_m_a_s_t_e_r._d directory.
  158.  
  159.      ----UUUU _i_d       Used to unload a dynamically loadable kernel module.  _i_d is
  160.                  found by using the _l_b_o_o_t -_V command.
  161.  
  162.      ----WWWW _i_d       Used to unregister a dynamically loadable kernel module.  _i_d
  163.                  is found by using the _l_b_o_o_t -_V command.
  164.  
  165.      ----VVVV          Used to list all of the currently registered and loaded
  166.                  dynamically loadable kernel modules.
  167.  
  168.      It is best to reconfigure the kernel on a system with the _a_u_t_o_c_o_n_f_i_g
  169.      command.
  170.  
  171. EEEEXXXXAAAAMMMMPPPPLLLLEEEE
  172.           _llll_bbbb_oooo_oooo_tttt _----_ssss _n_e_w_s_y_s_t_e_m
  173.  
  174.      Reads the file named _n_e_w_s_y_s_t_e_m to determine which objects should be
  175.      configured into the bootable object.
  176.  
  177. FFFFIIIILLLLEEEESSSS
  178.      /var/sysgen/system
  179.      /var/sysgen/master.d/*
  180.      /var/sysgen/boot/*
  181.      /var/sysgen/mtune/*
  182.      /var/sysgen/stune
  183.  
  184. SSSSEEEEEEEE AAAALLLLSSSSOOOO
  185.      autoconfig(1M), setsym(1M), systune(1M), master(4), mload(4), mtune(4),
  186.      stune(4), system(4).
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195.                                                                         PPPPaaaaggggeeee 3333
  196.  
  197.  
  198.  
  199.